home *** CD-ROM | disk | FTP | other *** search
/ ADA Programming Guide / ADA Programming Guide.iso / adatutor / csparts / cspartd.src < prev    next >
Text File  |  1996-01-30  |  36KB  |  1,541 lines
  1. --::::::::::
  2. --acronyms.ptf
  3. --::::::::::
  4. .comment
  5. .! This include file contains a table of acronyms which is used
  6. .! in many of the DoD-STD-2167A documents.
  7. .comment
  8. .sp 2
  9. .ce
  10. .ul
  11. Acronyms
  12. .sp 1
  13. .nf
  14. .na
  15. .ul
  16. Acronym          Meaning
  17. CSC              Computer Software Component
  18. CSCI             Computer Software Configuration Item
  19. CSU              Computer Software Unit
  20. DID              Data Item Description
  21. DOD              Department of Defense
  22. HOL              High Order Language
  23. I/O              Input/Output
  24. IV&V             Independent Verification and Validation
  25. MIL-HDBK-1804    Military Handbook, Ada Style Guide
  26. PTF              Portable Text Formatter
  27. PTFIDX           Portable Text Formatter Indexer
  28. SRC              File type of a PAGER2 source file
  29. SUM              Software User's Manual
  30. VDD              Version Description Document
  31. .fi
  32. .comment
  33. .! The user may wish to add the following .ap command
  34. .! if auto-paragraphing is desired at this point in the document.
  35. .comment
  36. .! .ap
  37. --::::::::::
  38. --header.ptf
  39. --::::::::::
  40. .comment
  41. .! Enter the name of the system below
  42. .comment
  43. .vs SYSNAME CS PARTS
  44.  
  45. .comment
  46. .! This is set for PICA type (10 chars/inch).  Change accordingly
  47. .! for ELITE or other type styles.  Also, the default top and bottom
  48. .! margins and headers are used, giving 1 inch top and bottom for
  49. .! both margins and headers at 6 lines/inch.  No auto-paragraphing.
  50. .comment
  51. .lm 11
  52. .! This is set for ELITE, not PICA  -- .rm 70
  53. .rm 92
  54.  
  55. .comment
  56. .! Useful Macros (note that macros are in upper-case):
  57. .!
  58. .!   .SECT <indentation level> <number> <text>
  59. .!       -- define a section which appears in the document and the
  60. .!       -- table of contents
  61. .!
  62. .!   .LIST <number of spaces to indent>
  63. .!       -- start a list of items; the list will be indented from the
  64. .!       -- right and left by the indicated number of spaces;
  65. .!       -- nothing is output by this macro -- only the indentation
  66. .!       -- is changed and the number of the next list element
  67. .!       -- is set
  68. .!
  69. .!   .LE <text>
  70. .!       -- enter a new list item into the list; this may be
  71. .!       -- followed by more lines containing text associated
  72. .!       -- with the list entry; a blank line is generated followed
  73. .!       -- by a list element number, a period, and <text> extended
  74. .!       -- to the left by the <number of spaces to indent> set by
  75. .!       -- the .LIST macro
  76. .!
  77. .!   .ELIST
  78. .!       -- end a list of items; the indentation set by .LIST is
  79. .!       -- unset; a break is issued
  80. .!
  81. .!   .SLIST <number of spaces to indent>
  82. .!       -- start a sublist of items while in a list; the sublist will
  83. .!       -- be further indented from the right and left by the
  84. .!       -- indicated number of spaces
  85. .!
  86. .!   .SLE <text>
  87. .!       -- enter a new list item into the sublist; this may be
  88. .!       -- followed by more lines containing text associated
  89. .!       -- with the sublist entry; a blank line is generated
  90. .!       -- followed by N.M (N=list element number, M=sublist number),
  91. .!       -- a period, and <text> extended to the left by the
  92. .!       -- <number of spaces to indent> set by the .SLIST macro
  93. .!
  94. .!   .ESLIST
  95. .!       -- end a sublist of items and continue with the list
  96. .!
  97. .!   .PP
  98. .!       -- skip a line and start a new paragraph, indented by 5
  99. .!       -- spaces
  100. .!
  101. .!   .FIG <indentation level> <text>
  102. .!       -- enter a figure into the "List of Figures"
  103. .!
  104. .!   .PRFIG
  105. .!       -- print the "List of Figures"
  106. .!
  107. .!   .TAB <indentation level> <text>
  108. .!       -- enter a table into the "List of Tables"
  109. .!
  110. .!   .PRTAB
  111. .!       -- print the "List of Tables"
  112. .!
  113. .comment
  114.  
  115. .! ------------------------------------------------
  116. .define SECT
  117. .sp 2
  118. .need 10
  119. @2
  120. .ul
  121. @3 @4 @5 @6 @7 @8 @9
  122. .br
  123. .contline @1 @2 @3 @4 @5 @6 @7 @8 @9
  124. .en
  125. .! ------------------------------------------------
  126. .define LIST
  127. .vs LISTINDENT @1
  128. .li +@LISTINDENT
  129. .ri +@LISTINDENT
  130. .nr a 0
  131. .en
  132. .! ------------------------------------------------
  133. .define LE
  134. .sp
  135. .ti -@LISTINDENT
  136. .nr a +1
  137. @na.
  138. @1 @2 @3 @4 @5 @6 @7 @8 @9
  139. .br
  140. .en
  141. .! ------------------------------------------------
  142. .define ELIST
  143. .br
  144. .li -@LISTINDENT
  145. .ri -@LISTINDENT
  146. .en
  147. .! ------------------------------------------------
  148. .define SLIST
  149. .vs SLISTINDENT @1
  150. .li +@SLISTINDENT
  151. .ri +@SLISTINDENT
  152. .nr b 0
  153. .en
  154. .! ------------------------------------------------
  155. .define SLE
  156. .sp
  157. .ti -@SLISTINDENT
  158. .nr b +1
  159. @na.@nb.
  160. @1 @2 @3 @4 @5 @6 @7 @8 @9
  161. .br
  162. .en
  163. .! ------------------------------------------------
  164. .define ESLIST
  165. .br
  166. .li -@SLISTINDENT
  167. .ri -@SLISTINDENT
  168. .en
  169. .! ------------------------------------------------
  170. .define PP
  171. .sp
  172. .ti +5
  173. .en
  174. .! ------------------------------------------------
  175. .define FIG
  176. .ul
  177. .ce
  178. Figure @2 @3 @4 @5 @6 @7 @8 @9
  179. .br
  180. .contsel 1
  181. .cl @1 @2 @3 @4 @5 @6 @7 @8 @9
  182. .contsel
  183. .en
  184. .! ------------------------------------------------
  185. .define PRFIG
  186. .contsel 1
  187. .bp
  188. .ce
  189. .ul
  190. List of Figures
  191. .sp 2
  192. .pc
  193. .contsel
  194. .en
  195. .! ------------------------------------------------
  196. .define TAB
  197. .ul
  198. .ce
  199. Table @2 @3 @4 @5 @6 @7 @8 @9
  200. .br
  201. .contsel 2
  202. .cl @1 @2 @3 @4 @5 @6 @7 @8 @9
  203. .contsel
  204. .en
  205. .! ------------------------------------------------
  206. .define PRTAB
  207. .contsel 2
  208. .bp
  209. .ce
  210. .ul
  211. List of Tables
  212. .sp 2
  213. .pc
  214. .contsel
  215. .en
  216.  
  217. .! Other macros specifically for this set of documents
  218. .!   TAX1 - Level 1 Taxonomy Entry
  219. .!   TAX1A - Level 1 Taxonomy Entry with TOC Entry
  220. .!   TAX2 - Level 2 Taxonomy Entry
  221. .!   TAX3 - Level 3 Taxonomy Entry
  222. .!   ID - File Identification
  223. .!   AUTHOR - Author Name
  224. .!   DEPEND - Dependencies
  225. .!   SPEC - Component Specification
  226. .!   SPEC2 - Component Spec with SHARP as Flag Char
  227. .de TAX1
  228. .spaceto +15
  229. Taxonomy:
  230. @1 @2 @3 @4 @5 @6 @7 @8 @9
  231. .br
  232. .contline
  233. .contline 2 @1 @2 @3 @4 @5 @6 @7 @8 @9
  234. .en
  235. .!
  236. .de TAX1A
  237. .spaceto +15
  238. Taxonomy:
  239. @1 @2 @3 @4 @5 @6 @7 @8 @9
  240. .br
  241. .en
  242. .!
  243. .de TAX2
  244. .ti +16
  245. @1 @2 @3 @4 @5 @6 @7 @8 @9
  246. .br
  247. .contline 3 @1 @2 @3 @4 @5 @6 @7 @8 @9
  248. .en
  249. .!
  250. .de TAX3
  251. .ti +20
  252. @1 @2 @3 @4 @5 @6 @7 @8 @9
  253. .br
  254. .contline 4 @1 @2 @3 @4 @5 @6 @7 @8 @9
  255. .en
  256. .!
  257. .de ID
  258. .sp
  259. .need 20
  260. Files:
  261. @1.SPC and @1.BDY
  262. .br
  263. .index @1
  264. .of /Part ID: @1//#/
  265. .ef /#//Part ID: @1/
  266. .en
  267. .!
  268. .de AUTHOR
  269. .index @1 @2 @3 @4 @5 @6 @7 @8 @9
  270. .en
  271. .!
  272. .de DEPEND
  273. .sp
  274. .need 20
  275. Dependencies on Other Components in CS Parts:
  276. .en
  277. .!
  278. .de SPEC
  279. .sp 2
  280. .need 20
  281. .ul
  282. Specification
  283. .sp 2
  284. .nf
  285. .ec \
  286. .fc ~
  287. .include ~1
  288. .fc
  289. .ec
  290. .fi
  291. .en
  292. .!
  293. .de SPEC2
  294. .sp 2
  295. .need 20
  296. .ul
  297. Specification
  298. .sp 2
  299. .nf
  300. .ec \
  301. .fc #
  302. .include #1
  303. .fc
  304. .ec
  305. .fi
  306. .en
  307. --::::::::::
  308. --id.ptf
  309. --::::::::::
  310. .comment
  311. .! Identification paragraph.
  312. .comment
  313.  
  314. .PP
  315. The @SYSNAME (short for
  316. .ul
  317. Computer Science
  318. Parts) shall also
  319. be known as
  320. .ul
  321. CS Parts.
  322. This name may be used interchangeably with
  323. "@SYSNAME" in the documentation for
  324. this software tool.
  325. --::::::::::
  326. --overview.ptf
  327. --::::::::::
  328. .comment
  329. .! This is a system overview, which is common to many
  330. .! of the DoD-STD-2167A DIDs.
  331. .comment
  332. .PP
  333. .ul
  334. CS Parts
  335. (short for
  336. .ul
  337. Computer Science
  338. Parts)
  339. is a collection of reusable Ada software components targetted to the
  340. .ul
  341. general purpose
  342. and
  343. .ul
  344. Computer Science and Computer Engineering education
  345. applications domains.
  346. These components were obtained from two sources: (1) the
  347. Ada Software Repository on
  348. SIMTEL20 and (2) the author of this project.
  349. All software extracted from the Ada Software Repository is public domain
  350. or carries an ACM-style copyright, which gives the user the right to
  351. freely copy and use this software.
  352. All software created by the author of this project is released to the
  353. public domain.
  354. .PP
  355. The components of
  356. .ul
  357. CS Parts
  358. are a mix of object-oriented and function-oriented designs.  They have
  359. been compiled on the DEC Ada and Verdix Ada compilers and can be considered
  360. to be relatively free of bugs, but the author presents the following
  361. disclaimer to cover his lack of liability for the use of this software.
  362. .PP
  363. .ul
  364. Disclaimer.
  365. This software and its documentation are provided "AS IS" and
  366. without any expressed or implied warranties whatsoever.  No warranties
  367. as to performance, merchantability, or fitness for a particular
  368. purpose exist.
  369. The user is advised to test the software thoroughly before
  370. relying on it.  The user must assume the entire risk and liability of
  371. using this software.  In no event shall any person or organization of
  372. people be held responsible for any direct, indirect, consequential or
  373. inconsequential damages or lost profits.
  374. --::::::::::
  375. --sum.ptf
  376. --::::::::::
  377. .comment
  378. .! Software User's Manual (2167A, DI-MCCR-80019A) for:
  379. .!   CS PARTS
  380. .! Prepared by: Richard Conn
  381. .! Date: 9 Mar 1991
  382. .!
  383. .! Description and Purpose:
  384. .!   1. The Software User's Manual (SUM) provides user personnel
  385. .! with instructions sufficient to execute one or more related
  386. .! Computer Software Configuration Items (CSCIs).
  387. .!   2. The SUM provides the steps for executing the software, the
  388. .! expected output, and the measures to be taken if error messages
  389. .! appear.
  390. .!   3. The information required by this DID (Data Item Descriptor)
  391. .! is directed to the functional user of the CSCI(s), as opposed
  392. .! to the operator of the computer system.  If this distinction does
  393. .! not exist, the user will need to refer to both the Computer
  394. .! System Operator's Manual and the SUM to operate the computer system
  395. .! and to use the CSCI(s).
  396. .!
  397. .! Tailoring Instructions:
  398. .!    To tailor this template, fill in the areas surrounded by
  399. .! [] as indicated.
  400. .comment
  401.  
  402. .comment
  403. .! The following reads in a set of macros used by all the 2167A
  404. .! document templates.  It also establishes the environment of the
  405. .! document (PICA or ELITE type, for instance).
  406. .comment
  407. .include header.ptf
  408. .comment
  409. .! Set the page heading to contain the Document Control
  410. .! Number and date.  The Document Control Number contains
  411. .! revision and volume identification as applicable.
  412. .comment
  413. .he //CS PARTS SUM: 9 March 1991//
  414.  
  415. .ce on
  416.  
  417. .comment
  418. .! The next line contains the revision indicator and the
  419. .! date of revision.
  420. .comment
  421.  
  422. Version 2: 9 March 1991
  423.  
  424. .spaceto +15
  425. SOFTWARE USER'S MANUAL
  426. .sp
  427. FOR THE
  428. .sp
  429. @SYSNAME
  430. .sp
  431. A Catalog of Reusable Ada Software Components
  432. for
  433. General Purpose Use
  434. and
  435. Computer Science and Computer Engineering Education
  436. .spaceto -20
  437. Prepared for:
  438. .sp
  439. The Ada Community
  440. .sp 2
  441. Prepared by:
  442. .sp
  443. Richard Conn
  444. Manager, Ada Software Repository
  445. Adjunct Professor, Department of Computer Science, UC
  446. Adjunct Professor, Department of Electrical and Computer Engineering, UC
  447. .ce off
  448.  
  449. .comment
  450. .! The next page starts with the Scope and is numbered 1.
  451. .! The table of contents is created at the end of the PTF
  452. .! output file and should be inserted after this title page.
  453. .comment
  454. .bp 1
  455. .fo //#//
  456. .cl
  457. .SECT 0 1. Scope
  458. .SECT 1 1.1. Identification
  459. .include id.ptf
  460. .SECT 1 1.2. System overview
  461. .include overview.ptf
  462. .SECT 1 1.3. Document overview
  463. .PP
  464. This document is the
  465. .ul
  466. Software User's Manual
  467. for the @SYSNAME.  It contains detailed instructions
  468. on how to use this collection of reusable Ada software components.
  469. The parts are divided into two main categories: function-oriented
  470. components and object-oriented components.  Within these categories,
  471. each part is presented in the order of its taxonomy entry.  The following
  472. information is given for each part: (1) its taxonomy entry, (2) the names
  473. of the files containing it, (3) the IDs of the other CS Parts on which it
  474. depends, and (4) a listing of its Ada specification.  In addition, its Part ID
  475. nomenclature is given at the bottom of each page on which the part is
  476. described.  An index is included which lists the Part IDs and other keywords
  477. of interest.
  478. .bp
  479. .cl
  480. .SECT 0 2. Referenced documents
  481. .PP
  482. The documents by Richard Conn and the Proposed MIL-HDBK-1804 are available
  483. through the Ada Software Repository (ASR)
  484. at White Sands Missile Range, New Mexico.  Send electronic mail to
  485. ADA-SW-REQUEST_@WSMR-SIMTEL20.ARMY.MIL.
  486. .LIST 4
  487. .LE ANSI/MIL-STD-1815A-1983
  488. .ul
  489. Reference Manual for the Ada Programming Language,
  490. United States Department of Defense, February 17, 1983.
  491. .LE Conn, Richard, PTF SUM.
  492. .ul
  493. Software User's Manual for the Portable Text Formatter (PTF),
  494. August 24, 1989.
  495. This SUM and the associated VDD are formatted by PTF.
  496. .LE Conn, Richard.  PTF VDD.
  497. .ul
  498. Version Description Document for the Portable Text Formatter (PTF),
  499. August 24, 1989.
  500. .LE DoD-STD-2167A
  501. .ul
  502. Defense System Software Development,
  503. United States Department of Defense, February 29, 1988.
  504. .LE Proposed MIL-HDBK-1804
  505. .ul
  506. Ada Style Guide,
  507. U.S. Army Information Systems Engineering Command (ISEC),
  508. April 30, 1988.
  509. Most of the specifications of the components in this
  510. parts catalog comply with MIL-HDBK-1804.
  511. .ELIST
  512.  
  513. .bp
  514. .cl
  515. .SECT 0 3. CS Parts Component Descriptions
  516. .cl
  517. .SECT 1 3.1. Function-Oriented Components
  518. .TAX1 Common Types
  519. .ID TYPES
  520. .AUTHOR Conn, Richard
  521. .DEPEND
  522. None
  523. .SPEC types.spc
  524. .bp
  525. .TAX1 Math Library
  526. .TAX2 Bit Manipulation Functions on Integers 1
  527. .ID BIT
  528. .AUTHOR Moore, Freeman
  529. .DEPEND
  530. None
  531. .SPEC bit.spc
  532. .bp
  533. .TAX1A Math Library
  534. .TAX2 Bit Manipulation Functions on Integers 2
  535. .ID LOGICAL
  536. .AUTHOR Orost, Joseph
  537. .DEPEND
  538. None
  539. .SPEC logical.spc
  540. .bp
  541. .TAX1A Math Library
  542. .TAX2 Matrix Functions
  543. .ID MATRIX
  544. .AUTHOR Lee, Roger
  545. .AUTHOR Adamson, Art
  546. .DEPEND
  547. None
  548. .SPEC matrix.spc
  549. .bp
  550. .TAX1A Math Library
  551. .TAX2 Random Number Generator
  552. .ID RANDOM
  553. .AUTHOR Whitaker, Bill
  554. .AUTHOR Conn, Richard
  555. .AUTHOR Bell, Ron
  556. .DEPEND
  557. None
  558. .SPEC random.spc
  559. .bp
  560. .TAX1A Math Library
  561. .TAX2 Trigonometic and Core Functions
  562. .ID MLIB
  563. .AUTHOR Courtwright, Terry
  564. .DEPEND
  565. None
  566. .SPEC mlib.spc
  567. .bp
  568. .TAX1 Search
  569. .TAX2 General-Purpose
  570. .ID SEARCH
  571. .AUTHOR Mendal, Geoff
  572. .DEPEND
  573. None
  574. .SPEC search.spc
  575. .bp
  576. .TAX1 Sort
  577. .TAX2 Quick
  578. .ID QSORT
  579. .AUTHOR Anderson, John
  580. .DEPEND
  581. None
  582. .SPEC qsort.spc
  583. .bp
  584. .TAX1A Sort
  585. .TAX2 Merge-Exchange, Quick, others
  586. .ID SORT
  587. .AUTHOR Mendal, Geoff
  588. .DEPEND
  589. None
  590. .SPEC sort.spc
  591. .bp
  592. .nr z 2
  593. .nr p 0
  594. .cl
  595. .SECT 1 3.2. Data-Oriented Components
  596. .TAX1 Array
  597. .TAX2 Dynamic
  598. .ID DARRAY
  599. .AUTHOR Kownacki, Ron
  600. .DEPEND
  601. None
  602. .SPEC darray.spc
  603. .bp
  604. .TAX1 Command Line
  605. .TAX2 Interface
  606. .ID CLI
  607. .AUTHOR Conn, Richard
  608. .DEPEND
  609. None
  610. .SPEC cli.spc
  611. .bp
  612. .TAX1A Command Line
  613. .TAX2 Processor
  614. .ID CLP
  615. .AUTHOR Conn, Richard
  616. .DEPEND
  617. CLI
  618. .SPEC clp.spc
  619. .bp
  620. .TAX1 File
  621. .TAX2 Binary (Byte)
  622. .ID BINFILE
  623. .AUTHOR Conn, Richard
  624. .DEPEND
  625. TYPES
  626. .SPEC binfile.spc
  627. .bp
  628. .TAX1A File
  629. .TAX2 Formatted Report
  630. .ID FOF
  631. .AUTHOR Conn, Richard
  632. .DEPEND
  633. None
  634. .SPEC fof.spc
  635. .bp
  636. .TAX1A File
  637. .TAX2 Input Text
  638. .ID IN
  639. .AUTHOR Conn, Richard
  640. .DEPEND
  641. None
  642. .SPEC in.spc
  643. .bp
  644. .TAX1A File
  645. .TAX2 Output Text
  646. .ID OUT
  647. .AUTHOR Conn, Richard
  648. .DEPEND
  649. None
  650. .SPEC out.spc
  651. .bp
  652. .TAX1 List
  653. .TAX2 Doubly-Linked
  654. .ID DLIST
  655. .AUTHOR Conn, Richard
  656. .DEPEND
  657. None
  658. .SPEC dlist.spc
  659. .bp
  660. .TAX1A List
  661. .TAX2 Singly-Linked 1
  662. .ID SLIST
  663. .AUTHOR Conn, Richard
  664. .DEPEND
  665. None
  666. .SPEC slist.spc
  667. .bp
  668. .TAX1A List
  669. .TAX2 Singly-Linked 2
  670. .ID LISTS
  671. .AUTHOR Altus, Buddy
  672. .DEPEND
  673. None
  674. .SPEC lists.spc
  675. .bp
  676. .TAX1 Queue
  677. .TAX2 Prioritized
  678. .ID PRIQUEUE
  679. .AUTHOR Wolfe, Bill
  680. .DEPEND
  681. None
  682. .SPEC priqueue.spc
  683. .bp
  684. .TAX1 Set
  685. .TAX2 Character
  686. .ID CSET
  687. .AUTHOR Conn, Richard
  688. .AUTHOR Orost, Joseph
  689. .DEPEND
  690. None
  691. .SPEC2 cset.spc
  692. .bp
  693. .TAX1A Set
  694. .TAX2 General-Purpose
  695. .ID SET
  696. .AUTHOR Kownacki, Ron
  697. .DEPEND
  698. LISTS
  699. .SPEC set.spc
  700. .bp
  701. .TAX1A Set
  702. .TAX2 Hashed Mapping
  703. .ID HASHMAP
  704. .AUTHOR Kownacki, Ron
  705. .DEPEND
  706. HASHFCNS, LISTS
  707. .SPEC hashmap.spc
  708. .bp
  709. .TAX1A Set
  710. .TAX2 Ordered
  711. .ID ORDSET
  712. .AUTHOR Toscano, Bill
  713. .AUTHOR Gordon, Michael
  714. .DEPEND
  715. BINTREE2
  716. .SPEC ordset.spc
  717. .bp
  718. .TAX1A Set
  719. .TAX2 Permutation
  720. .ID PERMUTATE
  721. .AUTHOR Bryan, Doug
  722. .DEPEND
  723. None
  724. .SPEC permutate.spc
  725. .bp
  726. .TAX1 Stack
  727. .TAX2 General-Purpose
  728. .ID STACK
  729. .AUTHOR Kownacki, Ron
  730. .DEPEND
  731. LISTS
  732. .SPEC stack.spc
  733. .bp
  734. .TAX1 String
  735. .TAX2 C Library Routines
  736. .ID CSTRINGS
  737. .AUTHOR Conn, Richard
  738. .DEPEND
  739. None
  740. .SPEC cstrings.spc
  741. .bp
  742. .TAX1A String
  743. .TAX2 Case-Insensitive Comparison
  744. .ID CISC
  745. .AUTHOR Gordon, Michael
  746. .DEPEND
  747. None
  748. .SPEC cisc.spc
  749. .bp
  750. .TAX1A String
  751. .TAX2 Case-Sensitive Comparison
  752. .ID CSSC
  753. .AUTHOR Gordon, Michael
  754. .DEPEND
  755. None
  756. .SPEC cssc.spc
  757. .bp
  758. .TAX1A String
  759. .TAX2 Conversion
  760. .ID STRINGER
  761. .AUTHOR Conn, Richard
  762. .DEPEND
  763. None
  764. .SPEC stringer.spc
  765. .bp
  766. .TAX1A String
  767. .TAX2 Dynamic
  768. .ID DYN
  769. .AUTHOR Rubin, Sylvan
  770. .AUTHOR Cleaveland, R.G.
  771. .AUTHOR Conn, Richard
  772. .DEPEND
  773. None
  774. .SPEC dyn.spc
  775. .bp
  776. .TAX1A String
  777. .TAX2 General-Purpose
  778. .ID STRING
  779. .AUTHOR Kownacki, Ron
  780. .DEPEND
  781. LISTS, STACKS, CISC
  782. .SPEC string.spc
  783. .bp
  784. .TAX1A String
  785. .TAX2 Hash Function
  786. .ID HASHFCNS
  787. .AUTHOR Toscano, Bill
  788. .AUTHOR Gordon, Michael
  789. .DEPEND
  790. None
  791. .SPEC hashfcns.spc
  792. .bp
  793. .TAX1A String
  794. .TAX2 Parser 1
  795. .ID LPARSE
  796. .AUTHOR Conn, Richard
  797. .DEPEND
  798. None
  799. .SPEC lparse.spc
  800. .bp
  801. .TAX1A String
  802. .TAX2 Parser 2
  803. .ID SSCAN
  804. .AUTHOR Toscano, Bill
  805. .AUTHOR Gordon, Michael
  806. .DEPEND
  807. STRING
  808. .SPEC sscan.spc
  809. .bp
  810. .TAX1A String
  811. .TAX2 Parser 3
  812. .ID SCANNERS
  813. .AUTHOR Toscano, Bill
  814. .AUTHOR Gordon, Michael
  815. .DEPEND
  816. None
  817. .SPEC scanners.spc
  818. .bp
  819. .TAX1A String
  820. .TAX2 Time and Date Conversion
  821. .ID TOD
  822. .AUTHOR Mendal, Geoff
  823. .DEPEND
  824. SEARCH
  825. .SPEC tod.spc
  826. .bp
  827. .TAX1 Terminal
  828. .TAX2 Console
  829. .ID CONSOLE
  830. .AUTHOR Conn, Richard
  831. .DEPEND
  832. None
  833. .SPEC console.spc
  834. .bp
  835. .TAX1 Testing
  836. .TAX2 Unit Test Case Log
  837. .ID TESTLOG
  838. .AUTHOR Conn, Richard
  839. .DEPEND
  840. None
  841. .SPEC testlog.spc
  842. .bp
  843. .TAX1 Tree
  844. .TAX2 B+
  845. .ID BPLUSTREE
  846. .AUTHOR Wolfe, Bill
  847. .DEPEND
  848. None
  849. .SPEC bplustre.spc
  850. .bp
  851. .TAX1A Tree
  852. .TAX2 Binary 1
  853. .ID BINTREE
  854. .AUTHOR Toscano, Bill
  855. .AUTHOR Gordon, Michael
  856. .DEPEND
  857. None
  858. .SPEC bintree.spc
  859. .bp
  860. .TAX1A Tree
  861. .TAX2 Binary 2
  862. .ID BINTREE2
  863. .AUTHOR Toscano, Bill
  864. .AUTHOR Gordon, Michael
  865. .DEPEND
  866. LISTS
  867. .SPEC bintree2.spc
  868. .bp
  869. .TAX1A Tree
  870. .TAX2 Labeled
  871. .ID LTREES
  872. .AUTHOR Toscano, Bill
  873. .AUTHOR Gordon, Michael
  874. .DEPEND
  875. LISTS
  876. .SPEC ltrees.spc
  877. .bp
  878. .TAX1A Tree
  879. .TAX2 Labeled Binary
  880. .ID LBINTREE
  881. .AUTHOR Toscano, Bill
  882. .AUTHOR Gordon, Michael
  883. .DEPEND
  884. BINTREE
  885. .SPEC lbintree.spc
  886. .bp
  887. .cl
  888. .SECT 0 4. Error messages
  889. .of //#//
  890. .ef //#//
  891. .PP
  892. Most of the components in this library indicate errors by raising exceptions.
  893. These exceptions are documented with the components.
  894. .PP
  895. Four components, however, also display error messages.  These components
  896. are FOF, MLIB, QSORT, and VLENGTHIO (they can be quickly located by
  897. examining the index to this SUM).  Below are listed the error messages,
  898. with an explanation when one is required, for each of these components.
  899. .SECT 1 4.1. FOF
  900. .index FOF
  901. .PP
  902. These error messages reflect internal error conditions which
  903. should not occur in normal use.  These error conditions indicate a flaw
  904. in the logic of the associated routine.  The error messages are:
  905. .ec $
  906. .LIST 4
  907. .LE Internal error in FOF.Break_Line
  908. .LE Internal error in FOF.Break_Page (1st routine)
  909. .LE Internal error in FOF.Break_Page (2nd routine)
  910. .LE Internal error in FOF.Output_Bottom_Of_Page
  911. .LE Internal error in FOF.Put_Header_Footer_Line
  912. .LE Internal error in FOF.Pnum_As_String
  913. .LE Internal error in FOF.Put_Invisible_Word
  914. .LE Internal error in FOF.Put_Line
  915. .LE Internal error in FOF.Put_Word.Put_What
  916. .LE Internal error in FOF.Put_Word
  917. .LE Internal error in FOF.Set_Footer_Line
  918. .LE Internal error in FOF.Set_Header_Line
  919. .LE Internal error in FOF.Skip
  920. .LE Internal error in FOF.Output_Top_Of_Page
  921. .ELIST
  922. .ec
  923. .sp
  924. When FOF.Close is called, an error and a warning count are output.
  925. There are no predefined warnings, so the warning count should always be zero.
  926. .SECT 1 4.2. MLIB
  927. .index MLIB
  928. .PP
  929. The following messages are displayed by the MLIB component.
  930. Each message is prefixed with the name of the routine issuing it.
  931. .LIST 4
  932. .LE SQRT: CALLED SQRT FOR NEGATIVE ARGUMENT -nn.nn   USED ABSOLUTE VALUE
  933. .LE SQRT: EXCEPTION IN SQRT, X = nn.nn  RETURNED 1.0
  934. .LE CBRT: EXCEPTION IN CBRT, X = nn.nn  RETURNED nn.nn
  935. .LE LOG: CALLED LOG FOR NEGATIVE -nn.nn  USE ABS => nn.nn
  936. .LE LOG: CALLED LOG FOR ZERO ARGUMENT, RETURNED -nn.nn
  937. .LE LOG: EXCEPTION IN LOG, X = nn.nn  RETURNED 0.0
  938. .LE EXP: EXP CALLED WITH TOO BIG A POSITIVE ARGUMENT, nn.nn  RETURNED XMAX
  939. .LE EXP: EXP CALLED WITH TOO BIG A NEGATIVE ARGUMENT, -nn.nn  RETURNED ZERO
  940. .LE EXP: EXCEPTION IN EXP, X = nn.nn  RETURNED 1.0
  941. .LE "**": X**Y CALLED WITH X = nn.nn  USED ABS, RETURNED nn.nn
  942. .LE "**": X**Y CALLED WITH X = 0, y = nn.nn  RETURNED nn.nn
  943. .LE SIN: SIN CALLED WITH ARGUMENT TOO LARGE FOR ACCURACY nn.nn
  944. .LE COS: COS CALLED WITH ARGUMENT TOO LARGE FOR ACCURACY nn.nn
  945. .LE TAN: TAN CALLED WITH ARGUMENT TOO LARGE FOR ACCURACY nn.nn
  946. .LE COT: COT CALLED WITH ARGUMENT TOO NEAR ZERO nn.nn
  947. .LE COT: COT CALLED WITH ARGUMENT TOO LARGE FOR ACCURACY nn.nn
  948. .LE ASIN: ASIN CALLED FOR nn.nn (>1)  TRUNCATED TO 1, CONTINUED
  949. .LE ACOS: ACOS CALLED FOR nn.nn (>1)  TRUNCATED TO 1, CONTINUED
  950. .LE ATAN2: ATAN2 CALLED WITH 0/0  RETURNED nn.nn
  951. .LE SINH: SINH CALLED WITH TOO LARGE ARGUMENT nn.nn  RETURN BIG
  952. .LE COSH: COSH CALLED WITH TOO LARGE ARGUMENT nn.nn  RETURN BIG
  953. .ELIST
  954. .SECT 1 4.3. QSORT
  955. .index QSORT
  956. .PP
  957. QSORT returns one message, indicating an internal error.
  958. .LIST 4
  959. .LE QSORT: Exception Raised
  960. .ELIST
  961. .ec
  962. .bp
  963. .cl
  964. .SECT 0 5. Notes
  965. .include acronyms.ptf
  966.  
  967. .comment
  968. .! This appends a blank page to the end of a main body or
  969. .! appendix of the document.  This blank page may be removed
  970. .! if it is numbered odd or retained if it is even.
  971. .comment
  972. .bp
  973. .sp 20
  974. .ce
  975. This page intentionally blank
  976.  
  977. .comment
  978. .! End of blank page
  979. .comment
  980.  
  981. .bp 1
  982. .pn arabic Index-#
  983. .sp 2
  984. .ul
  985. Insert Index Here
  986. .cl
  987. .cl 0 Index
  988. .bp
  989. .comment
  990. .! The table of contents is automatically generated and placed
  991. .! here in the document file.  It should be physically moved to
  992. .! after the title page after printing the document.
  993. .comment
  994. .bp 2
  995. .pn lower_roman #
  996. .ce
  997. .ul
  998. Table of Contents
  999. .sp 2
  1000. .pc
  1001. .comment
  1002. .! This is provided in case the table of contents ends on an odd
  1003. .! page number.
  1004. .comment
  1005. .bp
  1006. .sp 20
  1007. .ce
  1008. This page intentionally blank
  1009. --::::::::::
  1010. --sumidx.ptf
  1011. --::::::::::
  1012. .comment
  1013. .! Software User's Manual (2167A, DI-MCCR-80019A) Index for:
  1014. .!   CS PARTS
  1015. .! Prepared by: Richard Conn
  1016. .! Date: 25 July 1990
  1017. .!
  1018. .! Description and Purpose:
  1019. .!   1. The Software User's Manual (SUM) provides user personnel
  1020. .! with instructions sufficient to execute one or more related
  1021. .! Computer Software Configuration Items (CSCIs).
  1022. .!   2. The SUM provides the steps for executing the software, the
  1023. .! expected output, and the measures to be taken if error messages
  1024. .! appear.
  1025. .!   3. The information required by this DID (Data Item Descriptor)
  1026. .! is directed to the functional user of the CSCI(s), as opposed
  1027. .! to the operator of the computer system.  If this distinction does
  1028. .! not exist, the user will need to refer to both the Computer
  1029. .! System Operator's Manual and the SUM to operate the computer system
  1030. .! and to use the CSCI(s).
  1031. .!
  1032. .! Tailoring Instructions:
  1033. .!    To tailor this template, fill in the areas surrounded by
  1034. .! [] as indicated.
  1035. .comment
  1036.  
  1037. .comment
  1038. .! The following reads in a set of macros used by all the 2167A
  1039. .! document templates.  It also establishes the environment of the
  1040. .! document (PICA or ELITE type, for instance).
  1041. .comment
  1042. .include header.ptf
  1043. .comment
  1044. .! Set the page heading to contain the Document Control
  1045. .! Number and date.  The Document Control Number contains
  1046. .! revision and volume identification as applicable.
  1047. .comment
  1048. .he //CS PARTS SUM: 25 July 1990//
  1049.  
  1050. .comment
  1051. .! The next page starts with the Scope and is numbered 1.
  1052. .! The table of contents is created at the end of the PTF
  1053. .! output file and should be inserted after this title page.
  1054. .comment
  1055. .pn arabic Index-#
  1056. .fo //#//
  1057. .include ptfidx.ptf
  1058. .comment
  1059. .! This is provided in case the index ends on an odd
  1060. .! page number.
  1061. .comment
  1062. .bp
  1063. .sp 20
  1064. .ce
  1065. This page intentionally blank
  1066. --::::::::::
  1067. --vdd.ptf
  1068. --::::::::::
  1069. .comment
  1070. .! Version Description Document (2167A, DI-MCCR-80013A) for:
  1071. .!   CS Parts
  1072. .! Prepared by: Richard Conn
  1073. .! Date: 9 March 1991
  1074. .!
  1075. .! Description and Purpose:
  1076. .!   1. The Version Description Document (VDD) identifies and describes
  1077. .! a version of a Computer Software Configuration Item (CSCI).
  1078. .!   2. The VDD is used by the contractor to release CSCI versions to
  1079. .! the Government.  The term "version" may be applied to the initial
  1080. .! release of a CSCI, to a subsequent release of that CSCI, or to one
  1081. .! of multiple forms of the CSCI released at approximately the same
  1082. .! time (e.g., to different sites).
  1083. .!   3. The VDD is used by the Government to track and control versions
  1084. .! of software to be released to the operational environment.
  1085. .!
  1086. .! Tailoring Instructions:
  1087. .!    To tailor this template, fill in the areas surrounded by
  1088. .! [] as indicated.
  1089. .comment
  1090.  
  1091. .comment
  1092. .! The following reads in a set of macros used by all the 2167A
  1093. .! document templates.  It also establishes the environment of the
  1094. .! document (PICA or ELITE type, for instance).
  1095. .comment
  1096. .include header.ptf
  1097.  
  1098. .comment
  1099. .! Set the page heading to contain the Document Control
  1100. .! Number and date.  The Document Control Number contains
  1101. .! revision and volume identification as applicable.
  1102. .comment
  1103. .he //CS PARTS VDD: 9 March 1991//
  1104.  
  1105. .ce on
  1106.  
  1107. .comment
  1108. .! The next line contains the revision indicator and the
  1109. .! date of revision.
  1110. .comment
  1111.  
  1112. Version 2: 9 March 1991
  1113.  
  1114. .spaceto +15
  1115. VERSION DESCRIPTION DOCUMENT
  1116. .sp
  1117. FOR THE
  1118. .sp
  1119. .comment
  1120. .! The name of the CSCI appears here
  1121. .comment
  1122. @SYSNAME
  1123.  
  1124. .spaceto -20
  1125. Prepared for:
  1126. .sp
  1127. The Ada Community
  1128. .sp 2
  1129. Prepared by:
  1130. .sp
  1131. Richard Conn
  1132. Manager, Ada Software Repository
  1133. Adjunct Professor, Department of Computer Science, UC
  1134. Adjunct Professor, Department of Electrical and Computer Engineering, UC
  1135. .ce off
  1136.  
  1137. .comment
  1138. .! The next page starts with the Scope and is numbered 1.
  1139. .! The table of contents is created at the end of the PTF
  1140. .! output file and should be inserted after this title page.
  1141. .comment
  1142. .bp 1
  1143. .fo //#//
  1144. .ec %
  1145. .cl
  1146. .SECT 0 1. Scope
  1147. .SECT 1 1.1. Identification
  1148. .PP
  1149. The @SYSNAME (short for
  1150. .ul
  1151. Computer Science
  1152. Parts) shall also be known as
  1153. .ul
  1154. CS Parts.
  1155. This name may be used interchangeably with "@SYSNAME" in the documentation
  1156. for this software tool.
  1157. .SECT 1 1.2. System overview
  1158. .include overview.ptf
  1159. .SECT 1 1.3. Documentation overview
  1160. .PP
  1161. This document identifies the files associated with the indicated version
  1162. (see title page) of @SYSNAME and contains installation instructions.
  1163. .bp
  1164. .cl
  1165. .SECT 0 2. Referenced documents
  1166. .PP
  1167. The documents by Richard Conn and the Proposed MIL-HDBK-1804 are available
  1168. through the Ada Software Repository (ASR)
  1169. at White Sands Missile Range, New Mexico.  Send electronic mail to
  1170. ADA-SW-REQUEST%@WSMR-SIMTEL20.ARMY.MIL.
  1171. .LIST 4
  1172. .LE ANSI/MIL-STD-1815A-1983
  1173. .ul
  1174. Reference Manual for the Ada Programming Language,
  1175. United States Department of Defense, February 17, 1983.
  1176. .LE Conn, Richard, ASRUH.
  1177. .ul
  1178. Ada Software Repository (ASR) User's Handbook,
  1179. Version 1, March 16, 1990.
  1180. .LE Conn, Richard, PTF SUM.
  1181. .ul
  1182. Software User's Manual for the Portable Text Formatter (PTF),
  1183. August 24, 1989.
  1184. This VDD and the associated SUM are formatted by PTF.
  1185. .LE Conn, Richard.  PTF VDD.
  1186. .ul
  1187. Version Description Document for the Portable Text Formatter (PTF),
  1188. August 24, 1989.
  1189. .LE DoD-STD-2167A
  1190. .ul
  1191. Defense System Software Development,
  1192. United States Department of Defense, February 29, 1988.
  1193. .LE Proposed MIL-HDBK-1804
  1194. .ul
  1195. Ada Style Guide,
  1196. U.S. Army Information Systems Engineering Command (ISEC),
  1197. April 30, 1988.
  1198. Most of the specifications of the components in this
  1199. parts catalog comply with MIL-HDBK-1804.
  1200. .ELIST
  1201. .bp
  1202. .cl
  1203. .SECT 0 3. Version description
  1204. .SECT 1 3.1. Inventory of materials released
  1205. .PP
  1206. Four files are distributed with this version of @SYSNAME:
  1207. .sp
  1208. .li +5
  1209. .nf
  1210. .ul
  1211.    File Name
  1212. 1. csparts.src
  1213. 2. cspartb.src
  1214. 3. clibody.src
  1215. 4. cspartd.src
  1216. .fi
  1217. .li -5
  1218. .PP
  1219. All four files are ASCII text files which were created by the PAGER2
  1220. tool.  They can be manipulated by PAGER2 or with a conventional text
  1221. editor.  See the
  1222. .ul
  1223. Ada Software Repository (ASR) User's Handbook
  1224. for further information on PAGER2.
  1225. .PP
  1226. Files 1-3 are software, described under section 3.2 below.  File 4
  1227. is documentation, containing PTF files which create the
  1228. .ul
  1229. Software User's Manual
  1230. and this
  1231. .ul
  1232. Version Description Document
  1233. for @SYSNAME:
  1234. .sp
  1235. .li +5
  1236. .nf
  1237. .ul
  1238. File Name       Contents
  1239. acronyms.ptf    List of acronyms
  1240. header.ptf      Macros and PTF settings
  1241. id.ptf          Common include file
  1242. overview.ptf    Common include file
  1243. sum.ptf         @SYSNAME Software User's Manual
  1244. sumidx.ptf      Creates index for SUM
  1245. vdd.ptf         @SYSNAME Version Description Document
  1246. .fi
  1247. .li -5
  1248. .PP
  1249. See the
  1250. .ul
  1251. Ada Software Repository (ASR) User's Handbook
  1252. and the PTF SUM and PTF VDD
  1253. for further information on PTF.
  1254. .SECT 1 3.2. Inventory of CSCI contents
  1255. .PP
  1256. The three source code files, csparts.src, cspartb.src,
  1257. and clibody.src, contain the Ada program unit specifications in compilation
  1258. order, the Ada program unit bodies (except for the body of package CLI)
  1259. in compilation order, and a selection of bodies for package CLI, respectively.
  1260. .PP
  1261. The files contained in csparts.src (in compilation order) are:
  1262. .sp
  1263. .li +5
  1264. .nf
  1265. .ul
  1266. Name
  1267. types.spc
  1268. console.spc
  1269. bintree.spc
  1270. bit.spc
  1271. bplustre.spc
  1272. cisc.spc
  1273. cli.spc
  1274. cset.spc
  1275. cssc.spc
  1276. cstrings.spc
  1277. darray.spc
  1278. dlist.spc
  1279. dyn.spc
  1280. fof.spc
  1281. hashfcns.spc
  1282. in.spc
  1283. lists.spc
  1284. logical.spc
  1285. lparse.spc
  1286. matrix.spc
  1287. mlib.spc
  1288. out.spc
  1289. permutat.spc
  1290. priqueue.spc
  1291. qsort.spc
  1292. random.spc
  1293. scanners.spc
  1294. search.spc
  1295. slist.spc
  1296. sort.spc
  1297. stringer.spc
  1298. testlog.spc
  1299. binfile.spc
  1300. bintree2.spc
  1301. hashmap.spc
  1302. ltrees.spc
  1303. set.spc
  1304. stack.spc
  1305. clp.spc
  1306. lbintree.spc
  1307. ordset.spc
  1308. string.spc
  1309. sscan.spc
  1310. tod.spc
  1311. .fi
  1312. .li -5
  1313. .PP
  1314. The files contained in cspartb.src (in compilation order) are:
  1315. .sp
  1316. .li +5
  1317. .nf
  1318. .ul
  1319. Name
  1320. types.bdy
  1321. console.bdy
  1322. bintree.bdy
  1323. bit.bdy
  1324. bplustre.bdy
  1325. cisc.bdy
  1326. cset.bdy
  1327. cssc.bdy
  1328. cstrings.bdy
  1329. darray.bdy
  1330. dlist.bdy
  1331. dyn.bdy
  1332. fof.bdy
  1333. hashfcns.bdy
  1334. in.bdy
  1335. lists.bdy
  1336. logical.bdy
  1337. lparse.bdy
  1338. matrix.bdy
  1339. mlib.bdy
  1340. out.bdy
  1341. permutat.bdy
  1342. priqueue.bdy
  1343. qsort.bdy
  1344. random.bdy
  1345. scanners.bdy
  1346. search.bdy
  1347. slist.bdy
  1348. sort.bdy
  1349. stringer.bdy
  1350. testlog.bdy
  1351. binfile.bdy
  1352. bintree2.bdy
  1353. hashmap.bdy
  1354. ltrees.bdy
  1355. set.bdy
  1356. stack.bdy
  1357. clp.bdy
  1358. lbintree.bdy
  1359. ordset.bdy
  1360. string.bdy
  1361. sscan.bdy
  1362. tod.bdy
  1363. .fi
  1364. .li -5
  1365. .PP
  1366. The files contained in clibody.src (only one of which should be
  1367. compiled) are:
  1368. .sp
  1369. .li +5
  1370. .nf
  1371. .ul
  1372. Name
  1373. clibody.inc
  1374. clialsys.ada
  1375. clicais.ada
  1376. cligenrl.ada
  1377. cliintgr.ada
  1378. climerdn.ada
  1379. cliverdx.ada
  1380. clivms.ada
  1381. .fi
  1382. .li -5
  1383. .SECT 1 3.3. Class I changes installed
  1384. .PP
  1385. The previous Version was Version 1, Dated 25 July 1990.  The following notes
  1386. apply to Version 2 changes only.
  1387. .PP
  1388. The packages in files
  1389. ANSI100.SPC and COT.SPC were removed and replaced by the one package
  1390. in file CONSOLE.SPC (as well as the BDY files) in order to provide
  1391. one complete Console object definition.
  1392. .PP
  1393. The packages in files VLENGTHIO.SPC and DAG.SPC (as well as the BDY files)
  1394. were removed due to portability problems and lack of use.
  1395. .PP
  1396. The package in the file MATRIX.SPC (and its BDY file) was updated, adding
  1397. new subroutines only.
  1398. .SECT 1 3.4. Class II changes installed
  1399. .PP
  1400. The previous Version was Version 1, Dated 25 July 1990.  The following notes
  1401. apply to Version 2 changes only.
  1402. .PP
  1403. The package in the file CSTRINGS.SPC (and its BDY file) was added.
  1404. .PP
  1405. The package in the file TESTLOG.SPC (and its BDY file) was added.
  1406. .SECT 1 3.5. Adaptation data
  1407. .PP
  1408. The file clibody.src contains the only system-dependent files.
  1409. It contains several bodies of the package CLI (whose specification is
  1410. in csparts.src) for different target platforms.  See the
  1411. installation instructions (paragraph 3.9, below) and the
  1412. .ul
  1413. Ada Software Repository (ASR) User's Handbook
  1414. for details on how to select these bodies.
  1415. .SECT 1 3.6. Interface compatibility
  1416. .PP
  1417. The previous Version was Version 1, Dated 25 July 1990.  The following notes
  1418. apply to Version 2 changes only.
  1419. .PP
  1420. Any programs using the packages in files ANSI100.SPC and COT.SPC may have
  1421. to be updated to use the package in the file CONSOLE.SPC.
  1422. .PP
  1423. The packages in VLENGTHIO.SPC and DAG.SPC have been removed.
  1424. .PP
  1425. All other changes are upward compatible with the previous version.
  1426. .SECT 1 3.7. Bibliography of reference documents
  1427. .PP
  1428. The documents provided with the @SYSNAME are:
  1429. .sp
  1430. .li +10
  1431. .nf
  1432. Software User's Manual for the @SYSNAME
  1433. Version Description Document for the @SYSNAME
  1434. .fi
  1435. .li -10
  1436. .PP
  1437. Both documents were written by Richard Conn and are included in the
  1438. distribution of @SYSNAME.  PTF is required to assemble them
  1439. for printing.
  1440. .SECT 1 3.8. Summary of change
  1441. .PP
  1442. The previous Version was Version 1, Dated 25 July 1990.  The following notes
  1443. apply to Version 2 changes only.
  1444. .PP
  1445. The following files (and their BDY files) were removed: ANSI100.SPC,
  1446. COT.SPC, DAG.SPC, and VLENGTHIO.SPC.
  1447. .PP
  1448. The following files (and their BDY files) were added: CONSOLE.SPC,
  1449. CSTRINGS.SPC, and TESTLOG.SPC.
  1450. .PP
  1451. The following files (and their BDY files) were updated: MATRIX.SPC.
  1452. .PP
  1453. All file names were shortened to eight characters with a three-character
  1454. extension.
  1455. .SECT 1 3.9. Installation instructions
  1456. .PP
  1457. Installation of @SYSNAME requires three steps:
  1458. .LIST 4
  1459. .LE Compilation of the Ada program unit specifications.
  1460. Compile the file csparts.src.  Depending on your compiler, you
  1461. may have to change its file type (e.g., from SRC to ADA or A).
  1462. If this file is too big for your Ada compiler to handle, break it into
  1463. its component files and compile these component files in compilation
  1464. order (see section 3.2 above for the names of the component files and
  1465. their compilation order).
  1466. .LE Compilation of the Ada program unit bodies.
  1467. Compile the file cspartb.src.  Depending on your compiler, you
  1468. may have to change its file type (e.g., from SRC to ADA or A).
  1469. If this file is too big for your Ada compiler to handle, break it into
  1470. its component files and compile these component files in compilation
  1471. order (see section 3.2 above for the names of the component files and
  1472. their compilation order).
  1473. .LE Compile the proper component file of clibody.src.
  1474. Break clibody.src into its component files and compile the body which
  1475. most closely matches your target environment.  See the file clibody.inc
  1476. and the
  1477. .ul
  1478. Ada Software Repository (ASR) User's Handbook
  1479. for further instructions and examples.
  1480. .ELIST
  1481. .sp 2
  1482. .PP
  1483. The SUM and VDD of @SYSNAME can be created by issuing the following
  1484. commands (which require PTF and PTFIDX):
  1485. .sp
  1486. .li +10
  1487. .nf
  1488. PTF sum.ptf sum.doc
  1489. PTFIDX
  1490. PTF sumidx.ptf sumidx.doc
  1491. PTF vdd.ptf vdd.doc
  1492. .fi
  1493. .li -10
  1494. .PP
  1495. The files created by these commands are: (1) sum.doc, which is a
  1496. printable Software User's Manual, (2) sumidx.doc, which is the printable
  1497. index to the Software User's Manual, and (3) vdd.doc, which is a
  1498. printable Version Description Document.
  1499. .SECT 1 3.10. Possible problems and known errors
  1500. .PP
  1501. There are no known errors in this software.
  1502. .bp
  1503. .cl
  1504. .SECT 0 4. Notes
  1505. .include acronyms.ptf
  1506.  
  1507. .comment
  1508. .! This appends a blank page to the end of a main body or
  1509. .! appendix of the document.  This blank page may be removed
  1510. .! if it is numbered odd or retained if it is even.
  1511. .comment
  1512. .bp
  1513. .sp 20
  1514. .ce
  1515. This page intentionally blank
  1516.  
  1517. .comment
  1518. .! End of blank page
  1519. .comment
  1520.  
  1521. .comment
  1522. .! The table of contents is automatically generated and placed
  1523. .! here in the document file.  It should be physically moved to
  1524. .! after the title page after printing the document.
  1525. .comment
  1526. .bp 2
  1527. .pn lower_roman #
  1528. .ce
  1529. .ul
  1530. Table of Contents
  1531. .sp 2
  1532. .pc
  1533. .comment
  1534. .! This is provided in case the table of contents ends on an odd
  1535. .! page number.
  1536. .comment
  1537. .bp
  1538. .sp 20
  1539. .ce
  1540. This page intentionally blank
  1541.